Skip to main content

OpenClaw 温湿度仪表盘教程

开始前请先完成 使用前准备 目录下的 [01-外设硬件配置]、[02-openclaw Ajetson-KEY配置]、[03-openclaw切换模型]、[04-AI语音交互配置]、[05-三种对话方案配置测试]。如果当前只使用 TUI / 飞书,可以先跳过 04。本文默认基础环境已经准备完成,只展开温湿度仪表盘项目本身。

1. 教程目标

本文通过“传感器 + 显示 + 指示”的组合,展示 OpenClaw 在桌面仪表盘场景中的多外设协同能力。完成本教程后,读者可以:

  • 了解如何把 DHT、OLED、RGB 和舵机组合成一个温湿度仪表盘

  • 通过飞书、TUI、语音代码三种方式和 OpenClaw 对话

  • 完成四个项目场景:实时读数、OLED 指标盘、RGB 状态灯、舵机指针映射

2. 硬件准备

  • OpenClaw 主控板

  • DHT 温湿度传感器

  • OLED 显示屏

  • RGB 灯带 / RGB 灯珠模块

  • [可选] AI语音模块+扬声器

  • 接线图

image-20260601095549027

3. 软件准备

教程中会用到的代码入口

  • 温湿度读取命令:/home/jetson/hardware_hal_demo/dht

  • OLED 控制命令:/home/jetson/hardware_hal_demo/oled

  • RGB 控制命令:/home/jetson/hardware_hal_demo/rgb

  • 舵机控制命令:/home/jetson/hardware_hal_demo/cli/servo

  • 语音入口:/home/jetson/voice_to_openclaw/src/main.py

这个项目和 AI 气象站很接近,但侧重点不同:

  • AI 气象站更强调“播报”和“解释”

  • 温湿度仪表盘更强调“显示”和“状态映射”

4. 测试项目基础能力

开始当前项目之前,请先完成一次 openclaw tui 基础对话自检;如果还没做,先看 [05-三种对话方案配置测试]。通过后,再进入温湿度仪表盘专项测试。

建议先进入 OpenClaw TUI:

openclaw tui

image-20260529194358126

然后依次测试下面几类指令:

  • 读取当前温湿度

  • 在 OLED 上显示当前温湿度

  • 如果环境正常就亮绿灯

  • 把舵机转到 90 度

5. 和 OpenClaw 对话的三种方案

方案适合场景优点建议定位
飞书远程查看状态、课堂演示方便远程读取当前面板数据展示“远程监测面板”
TUI本地调试、映射验证最容易排查读数和动作关系先跑通可视化链路
语音代码语音播报、桌面助手更贴近日常使用方式作为完整演示方案

如果选配了AI语音模块+扬声器,飞书对话、tui、whatsapp对话需要播报openclaw回复的内容,可以终端运行下面的程序,ai语音模块对话不需要重复运行

  • 修改是否打开播报参数

xxxxxxxxxx /home/jetson/voice_to_openclaw/.env xxxxxxxxxx ENABLE_TTS = true #这个参数就是控制是否播报,修改完保存,终端运行下面程序

  • 终端输入

xxxxxxxxxx cd ~/ voice_to_openclaw source . venv / bin / activate python \- m src . openclaw_session_tts

image-20260529194326500

5.1 飞书方案

飞书接入和机器人创建步骤请直接参考 [05-三种对话方案配置测试]。创建好之后,就可以在飞书里远程查看仪表盘状态,例如:

  • 温湿度仪表盘

image-20260428184244000

5.2 TUI 方案

如果已经完成第 0 篇中的 TUI 自检,直接进入终端文字对话:

xxxxxxxxxx openclaw tui

然后输入项目相关指令,例如:

  • 温湿度仪表盘

image-20260428184318072

5.3 语音代码方案

xxxxxxxxxx 需要选配 ai 语音交互模块 + 扬声器

语音模块安装、环境配置和基础唤醒流程请直接参考 [04-AI语音交互配置]。唤醒之后,就可以直接说出控制内容,例如:

  • 温湿度仪表盘

image-20260529194336084

6. 项目实现

注意:下面都是在 openclaw tui 方式进行对话演示,你也可以自己选择飞书或语音方式来完成。

6.1 场景一:实时读数

实验目标

读取当前温湿度,完成仪表盘的基础数据输入。

效果说明

OpenClaw 会先拿到温度和湿度读数,这些值就是后续 OLED、RGB 和舵机映射的基础。

示例指令

  • 读取当前温湿度

  • 现在温度和湿度是多少

  • 帮我刷新一下当前读数

6.2 场景二:OLED 指标盘

实验目标

把当前温湿度结果显示成简洁的 OLED 仪表盘内容。

效果说明

这里适合使用 metricsdht_oled 方式,把 TempHum 组合成一块紧凑的屏幕区域,形成一个小型数据面板。

示例指令

  • 在 OLED 上显示 Temp 和 Hum

  • 做一个简单温湿度面板

  • 把当前温湿度写到屏幕上

6.3 场景三:RGB 状态灯

实验目标

用 RGB 颜色表达当前环境属于正常、偏热、偏冷或偏干等状态。

效果说明

这个环节可以让仪表盘更直观。比如正常亮绿色,偏热亮黄色,异常亮红色,偏冷亮蓝色,一眼就能看出状态。

示例指令

  • 如果环境正常就亮绿灯

  • 如果温度高就亮黄灯

  • 如果湿度异常就亮红灯

6.4 场景四:舵机指针映射

实验目标

把温度或湿度映射到舵机角度,让舵机像仪表盘指针一样指向一个位置。

效果说明

例如把温度区间映射到 0 到 180 度,当前温度越高,舵机指针越往右。这个效果很适合做课堂展示,因为“数字变成物理动作”会非常直观。

示例指令

  • 用舵机像指针一样表示当前温度

  • 把当前温度映射到舵机角度

  • 让指针指向当前状态